Description

Builds a complete, multi-page Examples section into the python-sdk mkdocs docs, grounded entirely in the real agent-assembly-examples sources (README + src/). This expands the original single-page refresh of framework-examples.md into a full section so each framework gets a detailed, source-accurate walkthrough.

New docs/examples/ section

• Overview (examples/index.md) — entry point, the offline-by-default note, a "start here" path, and a table mapping each example to the governance control it demonstrates.
• Preparing the runtime environment (examples/preparing-the-runtime-environment.md) — shared prerequisites to run any Python example: install (pip install agent-assembly / uv sync --extra dev), cloning agent-assembly-examples, the real uv run python src/main.py (+ --mock) commands, mock vs. real-provider mode, and the example env vars (AGENT_ASSEMBLY_GATEWAY_URL default http://localhost:8080, AGENT_ASSEMBLY_API_KEY). Includes a note reconciling these example-specific vars with the SDK's own AASM_* / :7391 resolver chain.
• Framework support (examples/framework-support.md) — the refreshed adapter <-> example status table and the universal init_assembly() pattern, relocated here from docs/guides/framework-examples.md (via git mv, history preserved) and re-linked to the per-framework pages. Adds a LlamaIndex row.
• Nine per-framework pages, one per example, each with: what it demonstrates, the framework/library + version pins, how the init_assembly() adapter flow works, prerequisites & real run commands, an annotated code walkthrough from policy.py/tools.py/main.py, mkdocs admonitions for offline/mock caveats, the verbatim expected output, and links:
  • langchain-basic-agent, langchain-research-agent, langgraph, crewai-research-crew, openai-agents-sdk, pydantic-ai, google-adk, llamaindex-tool-policy, custom-tool-policy.

Nav + link wiring

• Adds a top-level Examples nav section (Overview -> Preparing the runtime environment -> Framework support -> the 9 framework pages) to mkdocs.yml.
• Removes the old guides/framework-examples.md nav entry and repoints all inbound references (index.md, quick-start.md, configuration.md, guides/index.md) to the new Examples section. The internal #langchain-quick-start anchor is preserved.

Docs-only change. Accuracy was the priority: every command, env var, flag, code excerpt, and expected-output block is taken from the real example README/src — nothing invented.

Type of Change

• ✨ New feature
• 🔧 Bug fix
• ♻️ Refactoring
• 📚 Documentation update
• 🚀 Release

Breaking Changes

• No
• Yes (please describe below)

Related Issues

• Related JIRA ticket: AAASM-2936
• Related GitHub issues: N/A

Closes AAASM-2936

Testing

Describe the testing performed for this PR:

• Unit tests added/updated
• Integration tests added/updated
• Manual testing performed
• No tests required (explain why)

Docs-only Markdown change — no code paths touched. Ran mkdocs build --strict locally (with the project's docs dependency group): the build passes with no broken nav entries and no broken internal links across the new section. Each per-example page was drafted directly from the upstream README.md + src/*.py so commands, env vars, code excerpts, and expected output match the real examples.

Checklist

• Code follows project style guidelines
• Self-review completed
• Comments added for complex logic
• Documentation updated if needed
• All tests passing (mkdocs build --strict clean)